home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmeNamedSource.z
/
XmeNamedSource
Wrap
Text File
|
1998-10-30
|
9KB
|
133 lines
XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee - A toolkit function that takes ownership of
a named selection
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/TransferP.h>
BBBBoooooooolllleeeeaaaannnn XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee(
WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
AAAAttttoooommmm nnnnaaaammmmeeeedddd____sssseeeelllleeeeccccttttiiiioooonnnn,
TTTTiiiimmmmeeee ttttiiiimmmmeeee);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee takes ownership of the specified selection.
This routine establishes a function that is called when the
widget is asked to convert the selection named
_n_a_m_e_d__s_e_l_e_c_t_i_o_n. That function makes the following sequence
of calls:
1. Calls the application's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
if any. XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee passes an
XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt(with the _s_e_l_e_c_t_i_o_n member set
to _n_a_m_e_d__s_e_l_e_c_t_i_o_n) to each of these
XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures.
2. Calls the source widget's ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method;
ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc is one of the trait methods of the
_X_m_Q_T_t_r_a_n_s_f_e_rtrait. However, if any XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
procedure returns XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE or XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE,
then XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee will not call ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc.
This routine also establishes a function that is called when
the widget loses the selection. That function makes the
following sequence of calls:
1. Calls the application's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
if any. XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee passes an
XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto each of these
XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures. XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee
initializes the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttas follows:
+o Sets the _s_e_l_e_c_t_i_o_n member to the _n_a_m_e_d__s_e_l_e_c_t_i_o_n
argument
+o Sets the _t_a_r_g_e_t member to ____MMMMOOOOTTTTIIIIFFFF____LLLLOOOOSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
2. Calls the source widget's ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method.
However, if any XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure returns
XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE or XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE, then
Page 1 (printed 10/24/98)
XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee((((3333XXXX))))
XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee will not call ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc.
_w_i_d_g_e_t Specifies the widget that is to take ownership of
the selection.
_n_a_m_e_d__s_e_l_e_c_t_i_o_n
Specifies the AAAAttttoooommmm that names the selection to
own.
_t_i_m_e Specifies the time of the transfer. This is
usually the timestamp from the event passed to an
action routine. You should call
_X_t_L_a_s_t_T_i_m_e_S_t_a_m_p_P_r_o_c_e_s_s_e_d to generate the
_t_i_m_evalue. If you set _t_i_m_e to CCCCuuuurrrrrrrreeeennnnttttTTTTiiiimmmmeeee or 0,
UTM will automatically change the call to
_X_t_L_a_s_t_T_i_m_e_S_t_a_m_p_P_r_o_c_e_s_s_e_d.
RRRREEEETTTTUUUURRRRNNNN
This function returns False if the widget cannot take
ownership of the specified selection. Otherwise, it returns
True.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3),
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3),
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
Page 2 (printed 10/24/98)